Magnum One/Magnum One (Mid-American Digital) (Disc Manufacturing).iso/d27/c_ln150a.arc/C-LN.DOC

Text File | 1990-08-02 | 12KB | 532 lines

                              C-LN

                 The Amazing Line Centering TSR














             Created by Programmers for Programmers














           Program and Documentation Copyright 1990 by
              Information Management Systems, Inc.
               42 North University Avenue, Suite 6
                       Provo, Utah  84601
                         [phone]



                    C-LN 1.50  ·  Users Manual



LICENSE

This software is copyrighted and exclusively published by
Information Management Systems, Inc.  C-LN is distributed under the
Shareware concept to give users the opportunity to try software and
determine its suitability before spending their money on the
product.

Information Management Systems, Inc. hereby grants you a limited
license to use this software on an evaluation basis only.  If, at
the end of a reasonable evaluation period (we suggest 30 days), you
decide that C-LN does not suit your needs, simply erase all the
files associated with it, including the executable program and this
documentation.  If you decide that C-LN does suit your needs,
please remit $15.00 (in U.S. funds) to Information Management
Systems, Inc., 42 North University Avenue, Suite 6, Provo, Utah
84601.  Upon receipt of this registration fee, Information
Management Systems, Inc. will mail you the newest version of C-LN,
provide you with free telephone support, and notify you of major
upgrades and new products.

You are hereby granted additional license to copy and distribute C-
LN, as long as all the original, unmodified files are distributed
together.  No fee may be charged for the distribution of C-LN
except reasonable copying and shipping costs of $7.00 or less,
except by express written permission of Information Management
Systems, Inc.


WARRANTY

Information Management Systems, Inc. hereby disclaims all
warranties, expressed or implied.  This software and documentation
are supplied "as is" without warranty as to their merchantability
and/or fitness for a particular purpose.  In no event shall
Information Management Systems, Inc. or its suppliers be held
liable for any loss of profit, or any other commercial damage,
including but not limited to special, incidental, and consequential
damages.  This statement shall be construed, interpreted, and
governed by the laws of the state of Utah.












                                 i


                    C-LN 1.50  ·  Users Manual



TABLE OF CONTENTS

     License Agreement. . . . . . . . . . . . . . . . . . . . . i
     Warranty . . . . . . . . . . . . . . . . . . . . . . . . . i

     Purpose of the Software. . . . . . . . . . . . . . . . . . 1
     Installation . . . . . . . . . . . . . . . . . . . . . . . 2
     Using C-LN . . . . . . . . . . . . . . . . . . . . . . . . 3
     The Benefits of Registration . . . . . . . . . . . . . . . 5
     How to Get Help. . . . . . . . . . . . . . . . . . . . . . 6











































                                ii


                    C-LN 1.50  ·  Users Manual



PURPOSE OF THE SOFTWARE

As we write programs, we often find ourselves designing or
modifying screen layouts as we program.  It is very tiresome,
however, to count the number of characters in a string and center
it in a field or on the screen.

To solve or problem, we developed C-LN, a Terminate-and-Stay-
Resident (TSR) utility.  C-LN stands for Center-Line because the
program accepts a string of alpha-numeric characters and the field
length and calculates the number of spaces to place at the
beginning of the string to center it in the given field.  After
loading C-LN into memory, line-centering help is simply a hot key
away!

C-LN occupies approximately 40K of RAM, so load it in before you
start programming, and you'll never have to count characters again!




































                                 1


                    C-LN 1.50  ·  Users Manual



INSTALLATION

If your computer has a hard drive, we recommend you put C-LN in an
existing directory, perhaps a utilities directory.  If you don't
have a suitable directory, use the DOS commands to make one and
then log onto that directory.  (If you are unfamiliar with
manipulating directories in DOS, consult your DOS manual under
MKDIR and CHDIR.)  Then, place the C-LN distribution disk in the A:
drive and type

          copy A:C-LN.*

and press return.  DOS will then copy all the C-LN files to the
current directory on your current drive.

If your computer has two floppy drives, place a formatted diskette
in drive B: and the distribution disk in drive A: and type

          copy A:C-LN.* B:

and press return.  The C-LN files will then be copied onto the
diskette in drive B:.

If your computer has one floppy drive, get a blank disk.  Use DOS'
DISKCOPY command to make a copy of the distribution diskette.  With
the DISKCOPY program on a disk in drive A:, type

          diskcopy A: A:

and press return.  When prompted for the source disk, place the
distribution diskette in drive A:.  When prompted for the target
disk, place the blank diskette in drive A:.  The C-LN files will
all be copied onto the second diskette.




















                                 2


                    C-LN 1.50  ·  Users Manual



USING C-LN

Before C-LN can be used, it must be loaded into your computer's
memory.  To do this, log onto the drive that has C-LN.EXE on it and
change to the appropriate subdirectory.  (Alternately, if C-LN.EXE
is in a directory along your DOS PATH, you can execute it from any
directory or drive on your system.  See your DOS manual under PATH
for more details.)  At the DOS prompt, type

          C-LN

and press the Enter key.  C-LN automatically detects your video
mode and uses appropriate screen attributes.

After the program has been loaded into memory, a message will be
displayed on the screen identifying the program, version number,
the address of Information Management Systems, Inc., the
registration fee ($15.00), and a reminder of the hot key that
brings up the program.

After C-LN has been loaded into memory, it may be accessed at any
time by pressing the D key while holding down the Alt and Left
Shift keys.  This key combination should be unusual enough not to
interfere with your application programs, but you may wish to
reboot your system to remove C-LN from memory before compiling a
program.  Although we have taken reasonable efforts to ensure that
C-LN will not interfere with other programs, this safety measure is
wise with ALL resident (TSR) programs.

Upon pressing Alt-Left Shift-D, the C-LN window will pop up.  Enter
your the text you wish to center in the first field.  A maximum of
78 characters may be entered, and the field box will scroll to
accept the full 78 characters.

After pressing return, you will be asked for the length of the
field on which to center the text string.  Valid lengths are
between 1 and 80, inclusive.  Any number outside this range will
result in an error message.

C-LN will then display the positioning of the string on a numbered
ruler and will mark the starting position of the string.  If a
string is longer than the window can display, C-LN will truncate
the right hand side of the string for display purposes.  The
starting position is, however, the starting position for the full
string.

After displaying the centered string, you will have the option to
enter another string.  If you decide not to enter another string,
C-LN will remove its window from the display.  If you enter another
string, or the next time you access C-LN, the last string you
entered will be in the first field.  You may edit this string or


                                 3


                    C-LN 1.50  ·  Users Manual



type in a new string.  Pressing the Esc key while in this field
will cause C-LN to display the last string you entered and ask you
how long the field is on which the text should be centered.  (See
Editing Commands, below, for more editing commands.)

You will need to reenter the field length each time you center a
string.


EDITING COMMANDS

You may edit the first field, and several editing features have
been built into C-LN to assist you.  In the following descriptions,
whenever Ctrl- appears, you should press the indicated character
while holding down the Ctrl key.  If two letters follow Ctrl-,
press the first character while holding down the Ctrl key, then
press the second character.

Ctrl-S    Moves cursor left one character.
Ctrl-D    Moves cursor right one character.
Ctrl-A    Moves cursor left one word (can also use Ctrl-Left
          Arrow).
Ctrl-F    Moves cursor right one word (can also use Ctrl-Right
          Arrow).
Ctrl-Q S  Moves cursor to the beginning of the line (can also use
          the Home key).
Ctrl-Q D  Moves cursor to the end of the line (can also use the End
          key).
Ctrl-G    Deletes character at the cursor (can also use the Del
          key).
Ctrl-H    Deletes character to the left of the cursor (can also use
          the Backspace key).
Ctrl-Q Y  Deletes to the end of the line (can also use Ctrl-End).
Ctrl-Y    Deletes the entire line (can also use Ctrl-X).
Ctrl-Home Deletes from the beginning of the line to the cursor.
Ctrl-T    Deletes word to the right of the cursor.
Ins       Toggles the Insert mode.  A large cursor indicates Insert
          mode is on; a thin cursor indicates overwrite mode is on.
Ctrl-Q L  Restores the original contents of the line and allows you
          to continue editing (can also use Ctrl-R).













                                 4


                    C-LN 1.50  ·  Users Manual



THE BENEFITS OF REGISTRATION

Besides the moral satisfaction of doing the right thing, your
registration will encourage the development of more and better
Shareware and newer, more powerful utilities.  We also give some
special bonuses to those who pay the $15.00 registration fee:

     You will receive a disk with the latest version of C-LN on it
for your use and free distribution.
     You get a registration number which entitles you to free
telephone support directly from Information Management Systems,
Inc.
     You will be notified of all major upgrades to C-LN as well as
new products and utilities.
     And you will also receive our thanks for your support!






































                                 5


                    C-LN 1.50  ·  Users Manual



HOW TO GET HELP

If you are a registered user of C-LN, you are entitled to free
telephone support directly from Information Management Systems,
Inc.  Before you call, please obtain the following information to
help us answer your question:

     Product name and version number.  (The version number appears
on the diskette label and the screen that appears when C-LN is
first loaded.)

     Your registration number.  (Your registration number will be
on the diskette label.)

     Computer brand and model, and the brands and models of any
peripheral devices or other hardware.

     Operating system and version number.  (The version number of
PC-DOS or MS-DOS can be obtained by typing VER at the DOS prompt
and pressing the Enter key.)

     The telephone number for customer support is [phone].
The customer support line is open from 8:30 am to 5:00 pm Mountain
time.





























                                 6